home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / comm2 / kllttc25.lha / DOC / KILLATTACH.doc
Text File  |  1995-10-23  |  5KB  |  124 lines
  1.            KillAttach - File Attach Packet Killer for the Amiga
  2.        Copyright (c) 1995 by Robert Williamson, FIDONET#1:167/104.0
  3.                             ALL RIGHTS RESERVED
  4.  
  5.         This  software  is  provided  "as  is",  without warranty and/or
  6.     guarantee  of any kind.  You may use and/or distribute this software
  7.     and copies of it, as long as no alterations have been made, no files
  8.     have  been  added  to/omitted from the original distribution archive
  9.     and no charge is asked for.
  10.         This package may be freely distributed via BBSs, ADS, AmiNet and
  11.     software libraries such as Fred Fish's and Aminet CD-ROMs, and other
  12.     similar electronic channels.
  13.         This package may NOT be distributed by SAN or by Disk magazines,
  14.     PD  libraries  or  BBSs  and  Services  that  charge  extra for file
  15.     transfers  without  authorization  from,  and  compensation  to  the
  16.     author.
  17.  
  18.   What is KillAttach?
  19.     KillAttach  is  a  packet scanner which reads packets and deletes those
  20.   packets  which  contain  a  FileAttach message.  It only looks at packets
  21.   less  than 1000 bytes in length and then, only looks at the first message.
  22.   If  that  message is echomail or not a File Attach message, the packet is
  23.   skipped, if it IS a file attach message, the packet is deleted.
  24.  
  25.  
  26.   Status of This Release:
  27.     This  is  BETA  and  given the great number of features it probably has
  28.   bugs.  In the case of a serious ERROR, and if the error conditions allow,
  29.   the  error  message  will  be logged.  Please forward this information to
  30.   myself at either:
  31.                FIDONET#1:167/104.0 or AMIGANET#40:600/104.0.
  32.  
  33.     This  documentation may not be always up to date, as features are being
  34.   added  at  a  very  quick pace.  Refer to the KillAttach usage display for
  35.   command line changes.
  36.  
  37.     The  ToDo  list  is  changed  daily, items being either implemented and
  38.   removed  from  the list or new items added.  There is no obligation on my
  39.   part to implement anything in the ToDO list unless a contract to do so is
  40.   entered into by myself and a customer.
  41.  
  42.   Copyrights:
  43.     KillAttach, KillAttach.doc are
  44.        Copyright (c) 1995 by Robert Williamson, FIDONET#1:167/104.0
  45.  
  46.   Why did I write it?
  47.     It seemed the logical thing to do after writing PktFilter.
  48.  
  49.   Requirements:
  50.     WB 2.1 MINIMUM
  51.  
  52.   Features:
  53.     o pure, residentable, standard readargs command line templates
  54.     o multi-ftn
  55.     o independant of tosser and message base type
  56.     o handles both netmail and echomail
  57.  
  58.   Installation:
  59.     Be  sure that your dearc command preserves attributes.  If it does not,
  60.   run:
  61.     > Protect Mail:KillAttach pwerd
  62.  
  63.     Copy  KillAttach  to somewhere on your path, MAIL:  is nice.  For faster
  64.     loading, you can pre-load it as resident with these commands:
  65.     > Resident Mail:KillAttach ADD
  66.  
  67.     Make sure you REMOVE or REPLACE the old resident version when upgrading
  68.   and that you do not have any other program called KillAttach on your path.
  69.  
  70.     Copy rexxplslib.library to any directory of your LIBS:  assign.
  71.  
  72.    Copy  Start-ARexx  to  S:.   Then  remove  the call to RexxMast in your
  73.   S:Startup-Sequence and add a call to S:Start-ARexx to your S:User-Startup.
  74.   
  75.     Copy RPStart#? to your SYS:WBstartup directory. 
  76.  
  77.  
  78.   When to Scan packets:
  79.     Packet  scanning  can  be  done a number of ways.  Whichever method you
  80.   choose,  it  is  your  responsibiity  to  insure you do not scan the same
  81.   packet more than once.
  82.     The  BEST way to run KillAttach (or any packet scanner, for that matter)
  83.   is from a CRON, once a day, just before midnight, from a directory that
  84.   contains backups of all packets received.
  85.   
  86.       Run >NIL: KillAttach SCANDIR <path> AGE 0
  87.  
  88.     This  is  how I do it.  My tossing software allows me to backup packets
  89.   before tossing, even those within archives, and trim the backups by age.
  90.  
  91.     An  alternate  method  would  be  to scan each packet BEFORE importing.
  92.   While  this  is  trivial for packets received, when dealing with ArcMail,
  93.   this method would require one of:
  94.       -  a tosser that allows you to configure a command to execute between
  95.          de-arcing and tossing
  96.       -  modification  of  your  dearc  command  to  call  KillAttach before
  97.          returning to the tosser
  98.       -  some other trick you may come up with :) 
  99.   
  100.  
  101.   Templates: 
  102.     KillAttach  uses standard AmigaDos Templates for command line arguments.
  103.  
  104.   Command Line Usage:
  105.     The  various  modes allows use of KillAttach in WhenRecd, TurnAround and
  106.   AfterSession commands as well as in a cli.
  107.  
  108.  
  109.  Template:
  110.   SCANDIR/K,AGE/K,DEBUG/S
  111.  
  112.   SCANDIR dir <modifiers> <patterns>
  113.                  directory is scanned for all PKTs less or equal to AGE
  114.  Modifiers
  115.   AGE            number of days, the maximum age of packets to scan
  116.   DEBUG          extremely verbose mode
  117.  
  118.   Configuration:
  119.  
  120.     None.
  121.  
  122.  
  123.  --more to come--
  124.